// Copyright (C) 2022 即时通讯网(52im.net) & Jack Jiang.
// The RainbowChat Project. All rights reserved.
// 
// 【本产品为著作权产品，合法授权后请放心使用，禁止外传！】
// 【本次授权给：<广西木子科技有限公司>，授权编号：<NT220402151538>，代码指纹：<A.648883738.885>，技术对接人微信：<ID: Lingmuziyi>】
// 【授权寄送：<收件：李先生、地址：南宁市科园西十路11号国电智能大厦1101F、电话：17736659550、邮箱：yingshashou@vip.qq.com>】
// 
// 【本系列产品在国家版权局的著作权登记信息如下】：
// 1）国家版权局登记名(简称)和权证号：RainbowChat    （证书号：软著登字第1220494号、登记号：2016SR041877）
// 2）国家版权局登记名(简称)和权证号：RainbowChat-Web（证书号：软著登字第3743440号、登记号：2019SR0322683）
// 3）国家版权局登记名(简称)和权证号：RainbowAV      （证书号：软著登字第2262004号、登记号：2017SR676720）
// 4）国家版权局登记名(简称)和权证号：MobileIMSDK-Web（证书号：软著登字第2262073号、登记号：2017SR676789）
// 5）国家版权局登记名(简称)和权证号：MobileIMSDK    （证书号：软著登字第1220581号、登记号：2016SR041964）
// * 著作权所有人：江顺/苏州网际时代信息科技有限公司
// 
// 【违法或违规使用投诉和举报方式】：
// 联系邮件：jack.jiang@52im.net
// 联系微信：hellojackjiang
// 联系QQ号：413980957
// 授权说明：http://www.52im.net/thread-1115-1-1.html
// 官方社区：http://www.52im.net
package com.eva.framework;

import com.eva.epc.common.util.ESerializable;

/**
 * 处理器接口.<br>
 * 一个处理器实现者，在方法process(..)中可据job_dispatch_id找到对应的JobDispatcher，JobDispatcher
 * 又能据action_id进行对应动作的处理，以完全本次操作请求.
 *
 * @author Jack Jiang(http://www.52im.net/space-uid-1.html)
 * @version 1.0]
 * @see HttpController
 */
public interface Processor {
    /**
     * 处理器的核心实现方法.<br>
     * 可据job_dispatch_id找到对应的JobDispatcher，JobDispatcher又能据
     * action_id进行对应动作的处理，以完成本次操作请求.
     *
     * @param job_dispatch_id 作业调度ID
     * @param action_id       动作ID
     * @param Object          newData 客端发送过来的本次修改新数据(可能为空，理论上与oldData不会同时空）
     * @param Object          oldData 客端发送过来的本次修改前的老数据(可能为空，理论上与newData不会同时空）
     * @param User            user 包含该请求用户完整个人信息封装对象（该对象来自于成功登陆后存放于session中的值）
     * @return 任意类型返回值
     * @throws Exception 本方法调用中出现任何异常时都会抛出
     */
    public abstract Object process(int job_dispatch_id, int action_id, Object newData, Object oldData
            , User user) throws Exception;


    public static class User implements ESerializable {
//		/** 登陆账号 */
//		protected String login_name;
//		/** 登陆账号姓名（或称登陆者昵称） */
//		protected String true_name;
//		/** 登陆密码（用户输入的原始密码明文文本） */
//		protected String login_psw;
//		/** 账号是否可用：0 不可用、1 可用，默认1 */
//		protected boolean valid = true;
        //
//		/** 
//		 * 本字段用于存放用户成功登陆后，服务器当时的系统时间，用于返回给客户端后客户端检查本机时间以
//		 * 确保客户端的时间与服务器端时间相差太大，以保客户端的单据日期不会太离谱 .
//		 */
//		private String serverTimeAtLogin = null;

        /**
         * 本客户端的IP地址，目前仅用于登陆成功后，存放服务端读取出的客户端IP地址（理论上是外网IP），
         * 这样返回给客户端后在诸如考勤登记时就可以记下IP地址，以防作弊 。
         * <p>
         * 2011-06-23 add by JS.
         */
        private String ip = null;
        private String userUid = null;

        public String getUserUid() {
            return userUid;
        }

        public void setUserUid(String userUid) {
            this.userUid = userUid;
        }

        //		public String getLoginName()
//		{
//			return login_name;
//		}
//		public void setLoginName(String login_name)
//		{
//			this.login_name = login_name;
//		}
        //
//		public void setValid(boolean valid)
//		{
//			this.valid = valid;
//		}
        //
//		public String getLoginPsw()
//		{
//			return login_psw;
//		}
//		public void setLoginPsw(String login_psw)
//		{
//			this.login_psw = login_psw;
//		}
//		public boolean isValid()
//		{
//			return valid;
//		}
//		public String getTrueName()
//		{
//			return true_name;
//		}
//		public void setTrueName(String true_name)
//		{
//			this.true_name = true_name;
//		}
        //
//		public String getServerTimeAtLogin()
//		{
//			return serverTimeAtLogin;
//		}
//		public void setServerTimeAtLogin(String serverTimeAtLogin)
//		{
//			this.serverTimeAtLogin = serverTimeAtLogin;
//		}

        public String getIp() {
            return ip;
        }

        public void setIp(String ip) {
            this.ip = ip;
        }

//		public String toString()
//		{
////			return "user:"+this.yhm+"<"+this.xm+">";
//			return this.login_name;
//		}
        //
//		/**
//		 * <p>
//		 * 如果是超级管理员，本方法返回true.
//		 * 目前只有"admin"是超级管理员，它无权限限制（拥有所有功能的权限）.
//		 * </p>
//		 * @return
//		 */
//		public final boolean isSuperMan()
//		{
//			return this.login_name.equals("admin");
//		}
    }

}
